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Abstract 


This document shows the process of applying for- 
matting to suitable media without needing a donor 
tape to copy the formatting information. This pro- 
cess can be applied to either first-party media or to 
third-party media after the appropriate mechanical 
modifications are made to the cassette tape casing. 
This method requires only software to generate the 
required signal, and a suitable recording device to 
transfer the resulting signal to tape. Once trans- 
ferred, the resulting tape can be used as any other 
digital data pack, for any required application. Ap- 
plications for this method include lowest-common- 
denominator software distribution and reconstruction 
of degraded data packs so that they can be used 
again. 


This paper is split into two sections, the first pro- 
viding an overview of the format of Coleco Adam Dig- 
ital Data packs, while the second provides the pro- 
cedure for formatting a data pack using the MAME 
castool. The first section may be skipped if the pro- 
cedure is all that is needed. 


This represents the long tail of collaborative 
work across multiple projects to solve a long term 
problem in the Adam community, and this paper 
would not have been possible without the efforts of 
many. 


Contents 

I An Overview of Digital Data 
Packs 

1 Physical Characteristics 


2 


1.1 Adapting an existing audio cassette. . 


Recorded Signal Characteristics 

21 Blotk Format 224044642 4444 
2.1.1 Header Bytes format ...... 

22 Track “Topology .. 4.664 .44444 

2.3 Tape layouts and block numbering 

2.4 Signal level considerations ....... 


II Data Pack Formatting Proce- 
dure 


3 


4 


5 


8 


Requirements 

Modifying an Audio Cassette 
Preparing the source image 
Generating the audio signal file 


Editing the audio signal file to fit on 
tape 


Recording the Audio Signal 


References 


o»»1 e. Ww 


List of Figures 


il Physical Characteristics of a Digital 
Wa Pai se Sh wig a 


2 GW Right Directory Block Layout 

3 HE Center Directory Block Layout . . 
4 Imported audio signal fille ....... 
5 Splitting from Stereo to Mono... .. 


6 Selecting all audio on a track ..... 


List of Tables 


1 DDP Block Format........... 


Z DDP Block Header Format ...... 


List of Algorithms 


1 MANGLE NUM............ 


Part I 


An Overview of Digital 
Data Packs 


Digital Data Packs are the standard data storage 
medium for the Coleco Adam computer. While the 
medium itself has a familiar form factor similar to 
audio cassettes, they not only have slight mechanical 
differences, but they also possess a block oriented for- 
matting of header information that is spread across 
the tape so that the data drive can find a specific unit 
of information!. 

While Coleco had told early reviewers of the 
Adam that the ability to format data packs would be 
implemented in an upgrade, this never happened, and 
likely ? was never intended to happen. With the short 
production lifetime of the system, there were a lim- 
ited number of digital data pack medium produced 
for the system, with many of them being thrown into 
waste, meaning there currently exists a limited num- 
ber of viable media in its original form. 

To counteract this, the remaining users of the 
system modified existing audio cassettes so that they 
would fit into digital data pack drives, while also 
modifying data packs so that they could fit into au- 
dio cassette recorders. Once both cassettes were 
modified, the original data pack is dubbed onto the 
new modified cassette, copying the required address 
marks in the process. This process, while effective, 
relies on the integrity of the original donor cassette, 
and the effectiveness of the recorder. Over time and 
use, the donor media will become less effective at 
making new copies, and the generational copying ef- 
fect present in dubbed copies further degrades the 
effectiveness of the resulting copies, and the donor- 
copy method that was devised by the Adam enthusi- 
ast community will eventually be ineffective. 

This paper defines a method of creating the re- 
quired waveform to be recorded onto a recipient data 
pack that does not require a donor pack. This is 
achieved entirely in software, and only requires a cas- 
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Figure 1: Physical Characteristics of a Digital Data 
Pack 


sette recorder to transfer the resulting signal onto 
tape. The software takes as input, an image of data, 
and generates an audio file > which can be recorded. 
The software can produce data packs in either of the 
two possible formats “*, and the resulting pack can be 
used for any particular application. 

But in order to understand how this is possible, 
an overview of the digital data pack is needed. 


1 Physical Characteristics 


The Adam’s Digital Data Packs share physical char- 
acteristics with the Philips Compact Cassette. In 
particular, the size, shape, and mechanical tolerances 
are compatible. Because the data drive requires much 
faster transport of tape, the cassette shell was not 
only made of more duable Lexan material, but the 
mechanical tolerances of the rollers and spools are 
optimized for significantly less wow and flutter. Fig- 
ure 1 is the insert that was packaged with each Coleco 
digital data pack, and shows the enhancements that 
Coleco added to deal with issues such as increased 
friction from increased speed. 

Because a traditional capstan is not used to 
guide the tape against the tape head, additional holes 
are needed on the bottom of the cassette shell to sta- 
bilize the tape path against the static roller and head 
assembly on the bottom of the drive. In addition, 
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there are two additional holes on the top left and 
right of the cassette shell on the back side of the cas- 
sette which serve to not only stabilize the cassette 
shell in the drive, but to ensure the cassette is only 
inserted in the front-facing manner. 

The length of first-party Digital Data Packs is 
roughly equivalent to 25.6 minutes of audio tape, 
meaning that an audio cassette with a side length 
of 30 minutes of audio is ideal for use. 


1.1 Adapting an existing audio cas- 
sette 


The process of adapting an audio cassette shell to be 
used as a digital data pack is described in [5] on page 
4, using a dremel or a drill with the appropriately 
sized bit to add the holes on the top and bottom of 
the cassette shell. The process of adapting an existing 
DDP to act as a donor, also present in [5] on page 
3 are not needed. Any suitable 60 minute cassette 
may be modified into a data pack. 


2 Recorded Signal Characteris- 
tics 


The pack topology is divided into two tracks, A and 
B, each with a very wide track width. The width 
is substantial enough to require recording the two 
seperate tracks on the two seperate sides, reversing 
track B to have the correct orientation. 

The two tracks each contain a phase modulated 
square wave, with a nominal bit cell width of 70 mi- 
croseconds. The presence of a transition at 31 mi- 
croseconds within the bit cell indicates the presence 
of a binary one, while the absence of this additional 
transition represents a binary zero. 

The tape transport travels at 80 inches per sec- 
ond, at an approximate 15,000 bits per second trans- 
fer rate ©, with a bit density of approximately 714.3 
bits per inch. 
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7 of bytes | Description 

1 Sync Byte (0x16) 

8 Header Bytes 

21 zero bytes for padding 

1 Sync Byte (0x16) 

1024 Block Payload 

21 zero bytes for padding 

1 Sync byte (0x16) 

2 XOR checksum 

2 zero bytes for padding 

922 sync bytes (OxAA) 

2 zero bytes for padding 
Table 1: DDP Block Format 


2.1 Block Format 


The complete format of each data block and its as- 
sociated header and synchronization bytes are de- 
scribed in [6]. Each data block consists of the items 
in Table 1. It is important to understand that the 
header containing the addressing information, and 
the data payload are stored together in the same 
track, but the data drive can not create the headers 
itself, so they must already be present on the data 
pack. 


2.1.1 Header Bytes format 


The header is present in each data block, and pro- 
vides not only the block number, but also the pack 
type, and track information, so that the type of pack 
can be determined on each and every read, to al- 
low for spontaneous insertion of different pack types, 
and is listed in Table 2. The two pack formats for 
Right and Center directory are defined entirely in this 
header. 

The header ID determines the pack type. The 
letters ’G’ ’W’ indicate that the pack is a right- 
directory pack, with blocks allocated sequentially 
starting from the beginning of the pack being block 
0, and the end of the pack being block 255. This for- 
mat is used by the Super Game tapes such as “Buck 
Rogers: Planet of Zoom.” See Figure 2. 

Conversely, the letters ’H’ ’E’ indicate that the 
tape has block 0 in the middle of the tape, with blocks 
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Figure 2: GW Right Directory Block Layout 


<— TAPE MOTION (block #s in hex) 
40 7F 0 3F 


80 BF CO FF 


Figure 3: HE Center Directory Block Layout 


going across the tape from that point, and wrapping 
back around to the middle. This format was used in 
the SmartBASIC, productivity programs, and blank 
data packs because it placed the directory block’ 
equidistant in the middle of the pack. See Figure 
3: 

Two bytes are reserved for the block number. 
While this does mean that up to 65535 possible blocks 
could be placed on a data pack, were there enough 
physical tape, in practice only 256 total blocks are 
defined, so the second byte is empty. Since the data 
drive is controlled by a 6801[3], the byte order is big- 
endian for any block numbers. 

An XORed copy of the block number is placed 
next, and is done such that adding the block and 
!INOT block numbers together should sum to zero. 

This is followed by a single byte indicating the 
total number of blocks in a given track, and is sub- 
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# of bytes | Description 
2 Header ID 
2 Block Number 
2 INOT Block Number 
1 Total Number of Blocks in Track 
1 XOR checksum of above 


Table 2: DDP Block Header Format 


tracted against the total # of blocks to determine if a 
block is on track A or B, by the data drive firmware. 


Finally, a one byte ones-complement checksum, 
the same as used by AdamNet|2] for each of its pack- 
ets, is placed at the end of the header. 


2.2 Track Topology 


Each of the 256 possible blocks is assigned onto one 
of two possible tracks, A or B, with each track con- 
taining 128 blocks. The beginning of each track has 
approximately 2,753 leading zeroes to act both as 
padding and synchronization to find the beginning 
of a data track. 


2.3. Tape layouts and block numbering 


The different tape layouts all sequentially number the 
blocks in exactly the same way, with block 0 being 
at the beginning of the tape, and block 255 being at 
the end of the tape. The difference lies in not only 
the block header (HE vs GW), but also the fact that 
the tape firmware has an additional subroutine called 
MANGLE_NUM® which divides the total number of 
blocks in half, adds that to the current block number, 
and throws away the carry, causing the value to wrap 
back around to zero. See the listing for Algorithm 1 


2.4 Signal level considerations 


To best match the signal level emitted by the data 
drive when writing data payload, the sample level for 
both tracks is set to -12 decibels [6] and is static for 
the duration of the recording. 
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Algorithm 1 MANGLE NUM 


MANGLE NUM 
TST | TAPE _TYPE_,D 

: SEE WHERE THE DIRECTORY IS — 
BEQ  MANGL END 

: AT BEGINNING, GO AWAY 


LDD BLOCKS _TRACK,D 
LSRD 
; DIVIDE BY 2 
ADDD WANTED BLOCK,D 
STD | WANTED BLOCK,D 
SUBD BLOCKS TRACK,D ; NON-EXTANT? 
BHS MANGL HI 
RTS 
: WE'RE OK, JUST RETURN 
MANGL_ HI 
LDD WANTED BLOCK,D ; SUBTRACT 
SUBD BLOCKS TRACK,D 
STD | WANTED BLOCK,D ; NOPE 
MANGL END 
RTS 


Part II 
Data Pack Formatting 
Procedure 


Formatting a data pack, while not trivial, is a 
straightforward procedure. It involves creating or us- 
ing a source data pack image, with each of the 256 
blocks sequentially placed in a file. This is known 
as .ddp format in the Coleco Adam community, and 
you can use any of the data pack image files present 
on sites such as the Adam Archive[8] as the source 
material for creating the signal file. Once the signal 
file is sourced, the ’castool[6]’ present in MAME can 
be used to generate the initial signal file. An audio 
editing tool such as ’Audacity|7]’ can then be used to 
do necessary edits before finally using a device such 
as a USB enabled cassette recorder[1| to transfer the 
data tracks onto a suitable cassette °. 
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It is assumed 
that mame installed via your package manager, or 
placed somewhere within your search path. 


Linux is used in the examples. 


3 Requirements 


The requirements to perform the procedure are: 


e Windows, Mac or Linux. Linux is shown here in 
this procedure 


The ability to compile C or C++ code. Windows 
can use the MAME windows binaries|4]. 


e A copy of MAME|4]. 
e An audio editing program, such as Audacity|7]. 
e A suitable cassette recording device||]. 


e A dremel or drill with a 5/32 drill bit as specified 
in [5] page 4. 


e A source DDP image, or a program to create an 
empty one, such as ’dd’ in Linux. 


e A blank USB stick large enough to hold the gen- 
erated audio files from castool. 


4 Modifying an Audio Cassette 


Starting with a suitable 60 minute audio cassette, 1° 
drill out the required two holes on the back side of 
the tape, as specified in “Audio Cassette Tape to a 
Adam DDP Pack!!” [5] on page 4. 


Verify that the newly drilled cassette will fit 
in your data pack drive, before proceeding. 


5 Preparing the source image 
A DDP image is required. At a minimum a file con- 


taining all zeroes for 262,144 bytes is sufficient, and 
can be created with the following command: 


l0e.9. Sony HF-60 


$ dd if=/dev/zero of=blank.ddp bs=1024 count=256 


On Windows, Programs such as Adam Image Man- 
ager, which is available on the Adam Archive[8] can 
be used instead. 


6 Generating the audio signal 
file 


With the source image in hand, the castool[6] from 
MAME|4] can be used to generate the resulting audio 
signal file in WAV format, with the following com- 
mand: 


$ castool convert ddp blank.ddp blank .wav 


By default, castool will generate a center-directory 
audio image, with block 0 being in the middle of 
the data pack. Should you wish to generate a right- 
directory audio image, with block 0 being at the 
beginning of the tape, you will need to obtain the 
source code to mame, and modify lib/src/format- 
s/adam_cas.cpp on line 137 from: 


int layout type = TYPE HB; 
to: 
int layout type = TYPE GW; 


and subsequently recompile mame with 


$ make 


7 Editing the audio signal file to 
fit on tape 


The audio signal file, as it currently exists fresh out 
of castool, is formatted as a stereo audio file approxi- 
mately 25.6 minutes long. Figure 4 shows the zoomed 
out waveform as it exists when imported into Audac- 
ity. It needs to be split into two seperate mono files 
and silence added to both ends of the file. In addition, 
the audio file for the second track must be reversed 
so that it is in the correct orientation for the data 


Figure 4: Imported audio signal file 


drive’s abnormally wide playback head, with the fol- 
lowing procedure: 


1. In the File menu, select Import > Audio... 
2. Find and select blank.wav to open. 


3. Once open, split the stereo file, into mono using 
the track menu, see Figure 5. 


4. Click on the first track inside the waveform win- 
dow. Then press Shift-Home to skip to beginning 


5. From the Generate menu, select Silence... Spec- 
ify 20 seconds. This will add the appropriate de- 
lay to pass the initial leader, and enough slew to 
allow the data drive to properly sense the begin- 
ning of the track. 


6. Press Shift-End to skip to the end of the first 
track. 


7. Repeat Generate > Silence..., and this time 
specify 6 minutes. This will add the appropri- 
ate padding to the end of the tape to fill out the 
30 minutes. 


8. Repeat steps 4-8 with the second track. 


9. Press the Select button on the second track. See 
Figure X. This will select the entirety of track B. 


10. In the Effect menu, select Special > Reverse. 
This will reverse the audio signal, and the sec- 
ond track, should be in the opposite orientation 
of the first. 


11. Press the Select button of the first track. 


12. From the File menu, select Export > Export Se- 
lected Audio 


13. Ensure that the file format is 16-bit WAV, it 
should be, by default. 


14. Save the file as track_a.wav. 


15. Repeat steps 9 to 14, saving the resulting file as 
track_b.wav 


The resulting image files are ready for record- 
ing, and can be loaded individually back into Audac- 
ity to verify, before recording. Verify that the cor- 
rect amount of silence (20 seconds and 6 minutes) is 
present, and that it is reversed on track B. 

The audio files track _a.wav and track _b.wav 
should now be readied to be recorded. If the USB 
enabled recorder is used as cited, the track _a.wav 
and track b.wav files will be placed and recorded 
onto the recipient tape, one at a time. 


8 Recording the Audio Signal 


The following procedure assumes that the cited 
QFX USB enabled tape recorder is being used. If 
another recorder is used, the instructions must be 
adjusted accordingly. 


1. Ensure that the cassette recorder is plugged in, 
and switch is in the OFF position. Ensure that 
the volume knob is above 0. It does not matter 
where, as it is only monitoring the signal and not 
affecting how it is recorded. 


2. Copy track_a.wav onto the USB stick. 
3. Unmount the USB stick. 


4. Slide the cassette into the recorder, side A up. 
Rewind to the beginning if necessary. 


5. Place the USB stick into the USB port on the 
cassette recorder. 


6. Press the record and play buttons to arm it for 
recording. 
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Figure 6: Selecting all audio on a track 


7. Slide the recorder switch into the USB position. 
POWER should light, and the cassette trans- 
port should be moving. After approximately 30 
seconds, the digital audio signal for the tape for- 
matting should be heard. 


8. The process of recording side A should take ap- 
proximately 30 minutes, and the recorder will 
automatically stop. 


9. Slide the power switch to OFF. 


10. Remove the USB stick and place back in com- 
puter. 


11. Delete track_a.wav from the USB stick, and re- 
place with track_b.wav 


12. Repeat steps 3 to 9, for side B. 


The cassette is now ready to be used as a digital data 
pack. If you followed the instructions for a blank 
image, the data pack will need to be formatted e.g. 
using SmartBASIC or AJM File Manager, or a utility 
like Coleco TAPEUTL should be used to copy the 
image of a super game onto the data pack. 
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